Welcome to Codecov 🎉

Once you merge this PR into your default branch, you're all set! Codecov will compare coverage reports and display results in all future pull requests.

Thanks for integrating Codecov - We've got you covered ☂️

@calebdw Regarding the PHPDoc fix for Collection::load(): I used ...Relations\Relation): mixed... instead of ...Relations\Relation<*, *, *>): mixed... because PhpStorm can't parse the asterisks. Not sure if they're invalid here or it's just a PhpStorm bug.

@staudenmeir, the asterisks are valid, higher levels of PHPStan are going to require that the inner types are defined.
* in this case is a wildcard that just means a relation with any inner type is accepted

The problem is that the array is being parsed incorrectly and it thinks an array<callable> is expected instead of an array<array-key, callable>.

Try to update to:

// remove the space
/** @param  array<array-key,(callable(\Illuminate\Database\Eloquent\Relations\Relation): mixed)|string>|string  $relations */

// or try wrapping the array in parens
/** @param  (array<array-key, (callable(\Illuminate\Database\Eloquent\Relations\Relation): mixed)|string>)|string  $relations */

If this doesn't work then it's likely a phpstan parse error, try to replicate on https://phpstan.org/try and open an issue with phpstan

Thanks @calebdw. These updates don't fix the error, unfortunately.

Actually, this looks like it's because parameter types are not covariant which means you can't define a narrower type:

https://phpstan.org/r/0e4afb98-6c78-4076-9b50-5035cb0d8faf

The solution is to either use Relation or just don't type the closure (I tend not to add types to framework closures):

$users = User::all()->load([
    'ancestorPosts' => fn (Relation $query) => $query->orderBy('id'),
]);
// or
$users = User::all()->load([
    'ancestorPosts' => fn ($query) => $query->orderBy('id'),
]);

Thanks @calebdw. I typed the closures to get autocompletion from PhpStorm.

Do you know why the Eloquent builder mixin doesn't work here with fn (Relation $query)?

Call to an undefined method Illuminate\Database\Eloquent\Relations\Relation::orderBy().

@staudenmeir, the mixin is working fine when I add it to the framework tests. The issue may be that we're still waiting on larastan/larastan#1990 to be merged so that Larastan supports Laravel >= 11.15

@staudenmeir I also had to ignore this error in my other projects where I went to level 5/6

I've created a PR to fix this: #245
It also adds the phpstan/phpstan-phpunit extension

When laravel/framework#52724 gets released, we can remove the ignored error.

Thanks @calebdw and @SanderMuller.